* Terror Emacs

A minimal and functional configuration of [[https://emacs.org][GNU Emacs]] aimed at academic use, mainly for the creation of technical articles, presentations, literary programming and reproducibility. 

-----

*NOTE:* The =init.el= configuration file is automatically generated from =terror.org=, and is explained in detail in this file. A copy can be found [[https://cogitatur.cl/blog/terror/][here]]. 

-----

For full-featured Emacs distributions, it is highly recommended to check:

- [[https://github.com/hlissner/doom-emacs][Doom Emacs]]
- [[https://github.com/seagle0128/.emacs.d][Centaur Emacs]]
- [[https://www.spacemacs.org/][Spacemacs]]

Many ideas have been taken from System Crafters' EFS:

- [[https://github.com/daviwil/emacs-from-scratch][Emacs From Scratch]]

** Some features

- [[https://www.gnu.org/software/auctex/][AUCTeX]]
- [[https://orgmode.org/][Org Mode]] / [[https://www.orgroam.com/][Org-roam]] / [[https://github.com/takaxp/org-tree-slide][org-tree-slide]]
- [[https://github.com/jrblevin/markdown-mode][Markdown Mode]]
- [[https://github.com/bdarcus/citar][Citar]]
- [[https://github.com/fizban007/arxiv-mode][arXiv-mode]]
- [[https://github.com/skeeto/elfeed][Elfeed]]
- [[http://joostkremers.github.io/ebib/][Ebib]] / [[https://github.com/cpitclaudel/biblio.el][biblio.el]]
- [[https://github.com/politza/pdf-tools][PDF Tools]]
- [[https://github.com/joostkremers/writeroom-mode][Writeroom-mode]]
- [[https://magit.vc/][Magit]]
- [[https://github.com/joaotavora/yasnippet][YASnippet]]
- [[https://github.com/ianyepan/wilmersdorf-emacs-theme][Wilmersdorf Theme]]
- [[https://github.com/minad/vertico][Vertico]] / [[https://github.com/minad/marginalia][Marginalia]] / [[https://github.com/oantolin/orderless][Orderless]] / [[https://github.com/oantolin/embark/][Embark]]

** Requirements

- Git
- GNU Emacs (27.1+)
- JetBrains Mono (or any other font and replace it in =init.el=)
- PDF Tools (at the moment it is installed manually due to conflicts with =use-package=.)
  
On Debian GNU/Linux:

=# apt install git emacs fonts-jetbrains-mono=

With GNU Guix:

=$ guix install git emacs font-jetbrains-mono=

*** Optional

The following tools are optional and allow you to open files from =dired=. They can be replaced by any other package of choice in the corresponding section of =init.el=.

- nsxiv (image viewer)
- mpv (media player)

On Debian GNU/Linux:

=# apt install nsxiv mpv=

With GNU Guix:

=$ guix install nsxiv mpv=

** Installation

If any previous configuration exists, move it (or delete it):

=$ mv .emacs.d/ old-emacs-d=

Clone and rename the repository in ~/:

=$ git clone https://notabug.org/dlmayhem/terror-emacs.git .emacs.d=

Start Emacs /et voilà !/

Once all the packages are installed, all that remains is to run the following command inside Emacs:

=M-x all-the-icons-install-fonts=

* To do

- [X] Org Roam
- [X] Citar
- [X] YASnippet
- [ ] Screenshots

-----

*Happy hacking!*
